home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu295.dms / pu295.adf / Logging / IARULog / IARULOG.DOC < prev    next >
Text File  |  1988-12-21  |  6KB  |  124 lines
  1. IARULOG.BAS
  2. Original program by Clarke Greene K1JX
  3. Amiga version by John Gager K7KB
  4.  
  5. [See bug report at end of this file.]
  6.  
  7. This ARC file contains the Microsoft BASIC (tm) source code for the IARU HF
  8. Championship log editing program listed in the "Contests" chapter of The
  9. ARRL Operating Manual, Third Edition. The program takes an ASCII log listing
  10. (as created by you with your favorite word processor), and produces a log
  11. package suitable for submission to the contest sponsor.  Three separate files
  12. are produced:
  13.  
  14.     1. A LOG file - (identified by the filename extension ".LOG").  This file
  15.        holds the actual log.  New multipliers are identified and counted, QSO
  16.        point value noted, and duplicate contacts identified.
  17.  
  18.     2. A DUPE SHEET file - (identified by the filename extension ".DUP").
  19.        This file holds a dupe sheet as required by the contest sponsors.
  20.        This is a complete listing of all the  contacts made on a particular
  21.        band, in alphabetical order.
  22.  
  23.     3. A SUMMARY file - (identified by the filename extension  ".SUM"). This
  24.        file holds a summary sheet for the band edited. Total valid QSOs,
  25.        duplicate QSOs, total QSO  points, and multipliers worked are listed as
  26.        well as a complete breakdown of QSOs per multiplier.
  27.        
  28. The file containing the log entries must be an ASCII file in the following
  29. format:
  30.  
  31.     TIME      CALLSIGN      RCV'D REPORT
  32.  
  33. At least one space must be between each field of each log entry, and each line
  34. must be terminated by a carriage return.  Only a changed digit in the time
  35. field must be present; for example, if the contest begins at 1800Z and the
  36. first contact is made at 1802Z and the second contact is made at 1805Z, then
  37. only 5 need be entered in the time field. If the third contact is made at 
  38. 1812Z, then 12 should be entered in the time field. If the next contact is
  39. made at 1812Z, then no number need be entered in the time field (however, be
  40. sure to enter a space to indicate separation between fields).  If no signal
  41. report is entered as part of the received report, 59(9) (depending on the
  42. mode) is assumed.
  43.  
  44. The three output files (.LOG, .DUP, and .SUM files) can be printed by using
  45. the Amiga "TYPE" command.
  46.  
  47. Some reminders:
  48.  
  49. 1. Be sure your log is in an ASCII format.  Just about every word processor
  50.    can operate in an ASCII or Non-Document mode - that should work fine. As an
  51.    alternative, you can use one of the many utilities available in the
  52.    marketplace and in the public domain to convert your word processor output
  53.    into an ASCII format.  (See note below.)
  54.  
  55. 2. If enter the callsigns in your log in lower case, they are automatically
  56.    converted to upper case for the final .LOG file.
  57.  
  58. 3. Since you probably will copy this program onto a working disc (rather than
  59.    suffer the usual consequences of Mr. Murphy), remember that IARULOG needs
  60.    access to DXPREFIX.LIB. DXPREFIX.LIB must be on the same disc as this
  61.    program, and in the root or main directory of your disk.
  62.  
  63. 4. Each band requires a separate entry file.  The output files will be named
  64.    as the original filname plus the appropriate extension (for example
  65.    HFCW15.LOG, HFCW15.DUP, and HFCW15.SUM would be produced from the log entry
  66.    file HFCW15.)  As a consequence of this, any file with the same name will
  67.    be  overwritten when IARULOG is run. To avoid any deletion of valid files,
  68.    use unique names for the files used on each band and each mode, and don't
  69.    use the extensions .LOG, .DUP, or .SUM.
  70.  
  71. Special notes for Amiga Version
  72. -------------------------------
  73.  
  74. This ARC contains 4 files:
  75.  
  76. IARULOG.BAS  -  AmigaBasic program
  77.  
  78. IARULOG.DOC  -  This documentation file
  79.  
  80. IARULOG.DAT  -  A small log file used to show example log entrys and to test
  81.                 the IARULOG.BAS program.
  82.  
  83. DXPREFIX.LIB -  A file of DX prefixes and countries used by this program.
  84.  
  85.   To give credit where credit is due, this program is by Clarke Greene K1JX.
  86. The only thing I've done is go through his program and make it more agreeable
  87. with AmigaBasic, and add a few minor features along the way. I really haven't
  88. had a chance to test this program throughly since I don't get into contesting
  89. very much, but I believe it is free of any major bugs. If you find any bugs
  90. that I have missed, or have suggestions and comments about these programs,
  91. please let me know.
  92.  
  93.   One thing you will notice about these programs is that they are slow!! For
  94. example, I wrote a program that created a log using random prefixes from the
  95. DXPREFIX.LIB file. It created a log of 1439 entries, and the IARULOG.BAS
  96. program took about 1 1/2 hours to process the log! So patience is certainly a
  97. virtue when processing a large log. Although it would have been nice to
  98. compile these programs since I have the Absoft basic compiler, after I ran
  99. the compiled version of IARULOG on the same fake log, it took over 3 hours to
  100. process it! In some defense of Absoft, the MiniMuf program I wrote runs
  101. considerably faster compiled.
  102.  
  103. 73,
  104.  
  105. John Gager K7KB
  106. Compuserve ID 71336,624
  107.  
  108.  
  109. Bug report:
  110.  
  111. 1. Expanded DXPREFIX.LIB memory allocation for bigger library.
  112.  
  113. 2. Added ability for program to distinguish between between USA
  114.    prefix ambiguities (i.e. KG6= Guam vs. KG6= Calif.).  (Tnx WD5K)  
  115.  
  116. Amiga features include:
  117.  
  118.  * Automatic capitalizing of entries read from log source file.
  119.  
  120.  * Automatic capitalizing of keyboard entries from program prompts.
  121.  
  122.  * Expanded error checking for improper data read both from the log
  123.    source file and the keyboard.
  124.